home *** CD-ROM | disk | FTP | other *** search
/ Software 2000 / Software 2000 Volume 1 (Disc 1 of 2).iso / utilities / u130.dms / u130.adf / action!.doc < prev    next >
Text File  |  1987-04-27  |  8KB  |  224 lines
  1. Action! v1.0 Documentation
  2.  
  3.   This program uses text format, scene descriptions to present pictures,
  4. sounds and speech simultainiously.  Pictures are displayed in 32 colors
  5. with color cycle animation.  Sounds may be played in stereo or assigned
  6. to individual channels.  Multiline speeches may be used to provide
  7. detailed narration.  All of these features may be combined to produce
  8. sequential 'Video Movies'.  Additionaly, user interactivity, through
  9. keyboard function keys, makes possible the construction of tutorials and
  10. 'Adventure' games.
  11.  
  12.   To view the 'Action!' default scene, simply use the mouse pointer to
  13. 'Double Left Click' the 'Action!' tool icon or type 'Action!' at the CLI
  14. command prompt.  This will cause the disk to be searched for a directory
  15. named 'Scenes' and if found the scene named 'Action!' will be loaded.  If
  16. no 'Scenes' directory is found, an attempt will be made to load a scene
  17. named 'Action!.scene'.  To view a specific scene you may either 'Single
  18. Left Click' the scene's project icon then 'Shift Double Left Click' the
  19. 'Action!' tool icon or, from CLI type 'Action!' followed by the name of
  20. the scene to be loaded (e.g. Action! Scenes/Education).  Alternativly the
  21. scene's project icon may be altered to indicate 'Action!' as the default
  22. tool, then simply 'Double Left Click' the project icon.
  23.  
  24.   Scene descriptions and speeches may be written using Amiga's 'Notepad'
  25. or other simple text editors (e.g. Ed or Edit).  Speeches are written in
  26. phonetic text as described in the 'SoftTalk' chapters of the 'Amiga ROM
  27. Kernel Manual Volume 1' and Microsoft's 'Amiga Basic'.  Scene descriptions
  28. consist of one or more lines of 'Action!' commands and parameters as
  29. described below.  I use 'Electronic Arts Deluxe Paint' for my graphics,
  30. but other programs that save pictures in IFF ILBM format should work also
  31. (don't know about color cycling though).  Sounds must be in either IFF
  32. 8SVX oneshot format or 'Applied Visions FutureSound' jukebox format.
  33.  
  34.  
  35.  
  36. Action! Commands:
  37.  
  38. All commands consist of two capitalized characters.  Most commands are
  39. followed by one or more parameters.  In the following text, each parameter
  40. is indicated as one or more words surrounded by 'Less Than' and 'Greater
  41. Than' characters.  Optional parameters are additionaly surrounded by
  42. square bracket characters.
  43.  
  44.  
  45.  
  46. Pictures:
  47.  
  48. DP <picture file name> [<cycle speed percentage>]
  49.  
  50. This is currently the only command available for picture manipulation,
  51. the indicated file will be loaded and displayed with color cycling.
  52.  
  53. The picture file name may include device and directory specifications.
  54. Cycle speed percentage is optional and will default to 100.  This
  55. parameter may be set to zero to indicate no color cycling.
  56.  
  57.  
  58.  
  59. Speech:
  60.  
  61. ST <speech file name> [[[[[[<pitch>] <period>] <sex!>] <rate>] <mode>]
  62.    <volume>]
  63.  
  64. This command will load a speech file of up to 40 lines of 255 phonetic
  65. characters, then send one line at a time to the narrator until all lines
  66. have been sent.
  67.  
  68. The speech file name may include device and directory specifications.
  69. Pitch, period, sex, rate, mode and volume are optional and will default
  70. to the narrator devices normal defaults.  Detailed descriptions of these
  71. parameters may be found within Amiga documentation.
  72.   NOTE: The narrator device is mostly implemented in software and can
  73.         be CPU intensive.  Color cycling causes some degradition of the
  74.         narrators voice when using the default settings.  Use of lower
  75.         periods or rates can eliminate this effect.  Alternatively you
  76.         could set the cycle speed percentage, mentioned above, to zero
  77.         which would turn off cycling.
  78.  
  79. CT
  80.  
  81. This command's only function is to close any speech in progress and
  82. release the phonetic text from memory.  As speech will normaly continue
  83. from one scene to another this command is the only way to interrupt the
  84. narrator.
  85.  
  86. This command has no parameters.
  87.  
  88.  
  89.  
  90. Sounds:
  91.  
  92. BS <sound file name> [[<period>] <volume>]
  93.  
  94. This command will load and continualy play the indicated file through
  95. a pair of stereo (one left, one right) audio channels.
  96.  
  97. The sound file name may include device and directory specifications.
  98. Period and volume are optional and will default to the files settings
  99. (maximum volume will be used for JukeBox format file). The minimum
  100. acceptable value for period is 124.  Volume may range from 1 to 64.
  101.  
  102. SS <sound file name> [[[<cycle count>] <period>] <volume>]
  103.  
  104. This command will load and play the indicated file, through a pair of
  105. stereo audio channels.
  106.  
  107. The sound file name, period, and volume parameters are specified in the
  108. same manner as for the BS command.  The cycle count parameter is optional
  109. and will default to one playing.  If the cycle count is given, the sound
  110. will be repeated that number of times.  If the cycle count is set to zero
  111. the sound will be repeated endlessly (same as BS command).
  112.  
  113. SL <sound file name> [[[<cycle count>] <period>] <volume>]
  114.  
  115. This command is identical to the SS command, with the exception that only
  116. the left audio channel will be used for playback.
  117.  
  118. SR <sound file name> [[[<cycle count>] <period>] <volume>]
  119.  
  120. This command is identical to the SS command, with the exception that only
  121. the right audio channel will be used for playback.
  122.  
  123. CS <channel>
  124.  
  125. This command will close one or more audio channels and free the sound from
  126. memory.
  127.  
  128. Channel is optional and will default to stereo.  A channel specification
  129. of zero will close only the left audio channel, channel one will close only
  130. the right channel.
  131.  
  132.  
  133.  
  134. Control:
  135.  
  136. NN <scene file name> [<seconds>]
  137.  
  138. This command will push a scene onto the 'Node Stack' (a list of scene names
  139. to be loaded).  Repeated use of this command is permited and can be used
  140. to build a scene sequence.  As the 'Node Stack' is processed in a 'Last in
  141. First Out' methode, the last NN command will be processed first followed
  142. by the NN command prior to it, and so on.  When the current node 'Times
  143. out' the next scene on the stack will be loaded and performed.
  144.  
  145. The scene file name may include device and directory specifications.
  146. Seconds wait time is optional and will default to 60 seconds.  If wait time
  147. is set to zero seconds, there will be no delay between the processing of
  148. the current scene and the next scene on the stack.
  149.  
  150. WT [<seconds>]
  151.  
  152. This command sets the number of seconds to wait befor this scene 'Times
  153. out'.  If no scenes remain on the 'Node Stack' the 'Action!' program will
  154. terminate operation.
  155.  
  156. The seconds parameter is specified in the same manner as for the NN
  157. command.
  158.  
  159. N1 <scene file name>
  160.  
  161. This command is used to indicate the name of a scene to be loaded if the
  162. keyboard function key F1 is pressed.
  163.  
  164. The scene file name may include device and directory specifications.
  165.  
  166. N2 <scene file name>
  167.  
  168. This command functions identicaly to the N1 command with the exception that
  169. the F2 key is tested.
  170.  
  171. N3 <scene file name>
  172.  
  173. This command functions identicaly to the N1 command with the exception that
  174. the F3 key is tested.
  175.  
  176. N4 <scene file name>
  177.  
  178. This command functions identicaly to the N1 command with the exception that
  179. the F4 key is tested.
  180.  
  181. N5 <scene file name>
  182.  
  183. This command functions identicaly to the N1 command with the exception that
  184. the F5 key is tested.
  185.  
  186.  
  187.  
  188. Animation:
  189.  
  190. Not yet implemented.
  191.  
  192.  
  193.  
  194. Music:
  195.  
  196. Not yet implemented.
  197.  
  198.  
  199.  
  200. Well thats it for now, I hope you find 'Action!' useful and entertaining.
  201. I belive that all 'Bees and Spiders' have been exterminated, but I make
  202. no guarantees (those little creatures hide in the darndest places)!  Some
  203. scenes may work in 256K of memory but I recomend 512K.  If you recieve
  204. messages of insufficent memory, try closing windows and using the CT, CS
  205. commands to free speech and sound memory when not being used.
  206.  
  207. If you are intersted in receiving the latest version software, documentation
  208. and examples, please 'Support the Arts' by sending donations, disks,
  209. software (programs, graphics, sound), pictures of your girl friend, or
  210. whatever to:
  211.  
  212. Peter L. Dunlap
  213.  
  214. Mountain Micro Guild of Colorado
  215. P.O. Box 444
  216. Indian Hills, CO 80454
  217.  
  218. or
  219.  
  220. Mountain Micro Guild of California
  221. 33637 Windmill Rd.
  222. Lake Elsinore, CA 92330
  223.  
  224.